To: Rick Meyers — | : | Date: June 22, 1983 
From: George Cossey | | 
Subject: Evaluation of Glagnostic’ s harduare driver requirements. 


Hardware Interface for Lisa 1.75 


Tne following interfaces are needed, for the diagnostics, from the hardware 
interface in the Lisa 1.75 ROM. 


Overall, all routines that interface to the hardware must have safety timeouts in 
them to prevent endless hangs. The timeout error must also be reported to the caller. 


A11 data area used by the Hardware interface, for a scratch pad or to contain data, 
must reside in the Video memory. This makes it able to handle a system without any 
memory boards and imoroves diagnostic capability. The drivers must be able to run 
entirely in video memory, without ever using the main memory . 


There should be a way to réset the hardware interface software/nardware. Unknown 
changes may occur during a ahepiesto, and to Perry to a known state a reset may be 
necessary. i; | 4 

The timer chip. 


Timer #0 and #1 can be assumed to be vorking, this is one of the first tests done by 
he Boot ROM. | | 


Timer #0 - Need ¢ a handler for this timer, allows multiple timeouts to be set. 
Allows a previously set timeout to be queryed for remaining time and possibly deletion 
from the timer queue. Need a way to notify user program.that Eapeou has emiree, flag 
- resides inuser program and he passes you it’ saddress? . - 

Timer #1 - For Floppy driver. 


Timer #2 - For Speaker driver. 


Standard way to talk tothe COPS. ‘This means a way to send data and receive data 


with a timeout option, to get around a hang condition. Should be a way to talk to the 
COPS ina non-structured way, 1.e. not expect or send data in only sperdtne formats. 


A structured way to talk to the COPS should also be available. A change to the 
current method would bé to have a timeout on multiple byte data streams. This will 
allow getting out if only part of a mouse stream comes in, a timeout error should occur. 
This would also handie if ids dey data is atl sent, as inadate, and the COPS stops 
accepting data. 


should be able to use the cops in a polled mode or an interrupt mode . 


Need a handler for Speaker values, “volume and frequency. This latch requires a 
. shadow" to be kept in memory « ; : 


Need a handler for Contrast values. This latch requires a “shadow” to be kept in 
memory. 


A standard floppy driver, capable of beaace either the 871 or the Sony, using the 
IW chip. Primitive commands must be allowed, with error trapping. High level 
commands should be available with error trapping. | 


A built-in hard dis K driver.’ The special diagnostic commands in the disk drive 
must be accessiable. This driver must allow low level and high level commands. 


A Profile hard disk driver, driving out of a eee Interface card. This driver 
must allow low level and high level commands . 


Standard MMU regi ster routines, for reading ar and for writing. 


checksums inall ROMS must be ina standard place in the ROM for use during bootup. 
The same calculation method phat is in the Boot ROM must be used to generate this 
checksumnumber. i 


Driver for each of the RS232 ports. - : 


If errors from the dhtvers are to be logged iy a ai error handler, then that 
handler must have numerous nesturer for reset ta resang infotmation, etc. 


«* 


All error returns fro ine drivers must be addressed as to what the caller should 
do next. This especially applies to the Monitor and 0. S., the diagnostics will be 
written to handle all errors. | : | 

: E> m 

Suggested Video memory layout: _ 

ist screen-Mainuser screen. = - 

2nd screen - Alternate screen, used by diagnostics for ‘service mode . 

3ed screen - Graphics'scratch pad. 

4th screen - Data area and scratch pad for Boot ROM prograns, also contain enough 
area for eee Lion vectors and a small stack. 


Graphics required. 


Standard drawing features must be available. These include: 
Line drawing, including different size Les: 
Filling an area with a pattern. 

' Inverting an area. 
And others as needed. 


Full keyboard and House control, cursors and input handlers. 

Simple pulldown tabs, must work with either keyboard or mouse inputs. 

Buttons, must work with either keyboard or mouse inputs. 

Making a desktop. | | 

All graphics should work on both the standard and the alternate screen. This also 
means that it should be easy to switch between the two without having to redraw and 
resetup the screen. 

Alerts must be available, must work with either keyboard or mouse inputs. 

Icons, the special ones for diagnostics, must be allowed. anty simple drawing, 


hiliting, and moving is necegsary. It must be easy to add icons, an ideal way is to 
allow the user program to add icons to the standard ones used. 


1.75 Meetings 


June 30th — - 


Two video modes: 
1. Lisa mode has 720 x 364, 
2. Macmodenas 720 x 546. 
New code name is “wWhopper". 
Floppy drive. Sony will be the only floppy, there will not be a 871 in the 
system. NOTE: Ann is designing an expansion card that will connect to a Sony, an 
871, or an Apple II disk. Undecided if single or double sided Sony. 


Widget is the built-in hard disk. A profile vee a two-port card is a safety 
option if the Widget doesn’ t work. | 


150ns RAMS will be used in the video, possibly in the rest of the system. 
The 68010 processor will be used, 99% for. sure. The 68000 isa backup. 


There are currently & chips assigned for the Boot ROMS. This may go down to. 
4 chips and then down to 2chips. . 


There will have to bea MAGysound ecitivatent. 
Anew two-port card, tobe designed, will work in 1.75 and 1.0 


Next meeting is Thursday, July 14th at 1:30 PH. 


July 14th meeting. 


Only one (1) video serden, instead of the previous four. 
A sound generator, | of sorts, has been added. 
Unused video memory should be written to black. 

- Video memory containg an area for sound and nlerey speed. 


WORD . SOUND . SPEED 
‘BYTE BYTE 


A NMI button will be on the CPU board, must get: at it aya using some kind of a 
stick thru a vent hole. 


A special slot, four (4), for nenory boards and co-processors. 
There will bea Lignt on the Widget. 
No light or button on the Sony, 


July 28th meeting. 


Apple ComputerInc. —_inter-orrice tenorencun 


To: Distribution | (07/18/83 
From: George Cos sey 


Sub ject: Lisa 1.75 (whopper) Boot ROM Requirenents, revision 1. 


This reflects all the changes brought up at the meeting on Monday, July 18 
in the Sitting Bull conference room. If there are any questions or Changes then _ 
please contact me and I will generate & anew and improved document. 


LISA 1.75 — ROM —— Ps 


This document should be considered as a basic set of requirements for the 
new boot ROM in the -Lisa 1.75 system. Detailed information will be made 
available in a Program Reference Specification document to be distributed later 
(there will be ameeting called for that document also). . 


« The Lisa 1.75 Boot ROM should be considered as a totally new ROM and not as 

an adapted version of the Lisa 1.0 system. This means that any requirements for 
special operation, such as manufacturing burn-in, must be brougnt to the 
diagnostic groups attention as soon as possible. | 


t ea st = 


Display format. 


There must be a customer mode with minimal screen display and interaction, 
similar but not identical to that on the Lisa 1.0 Boot ROM. 


There must be a Service mode which produces extensive test results for 
failure evaluation and the debug tools necessary to look at the problem. This 
will allow better detugging 7s on: - exact test state and failure 
information. , | 


Test controls. 


The basic flow must be diagnostics, followed by hardware initialization, 
followed by the bootup of the selected device. 


There must be a service mode which allows for overriding any safety checks 
placed in there for customer mode , 


service mode must alsa have access to a ‘simple debugger and nave more 
extensive error logging on failures. This debugger must contain at least the 
features of the debugger in the current ROH, if possible then this debugger 
should be a subset of LisaBug and liriked to it in some manner. | 


If the system is doing a cold start and booting is taking place from the. 
built-in hard disk then the va dua should take advantage of this extra time 
ta run extended memory tests. 


If the system is doing dl ve warm start then there should be only very fast" 
diagnostics done and the user should have a minimal wait time. 

A special ‘fast’ bootup command should be added for booting from the floppy 
disk. This is for debugger's use. only and is restricted to the floppy. This 
restriction is to prevent this from becoming the new ' standard’ way of booting. 


‘Very long memory tests along with other interactive or long tests should be 
available if space permits, these will be called from service mode only. 


Bootable cevicas must include: 

a) Built-in hard clisk.. 

b) Built-in floppy disk, Sony. 

c) Expansion slots. . 

d) Serial port B using AppleBus, if ‘AppleBus software is ready. 

e) Serial port B using TALK. 

f) Automatic: burn-in of CPU board, using a sigrial bit from an edge 
connector pin. 

g) Automatic bootup, : described in Nenufacturing requirements. 


Option selection. 


Selection of any user options must allow for both Mouse and Keyboard entry 
in the customer mode, this means that all of Customer mode must work using only 
the mouse or only the keyboard or a combination of both. Keyboard entry is 
required in the service mode eeouaee™ | 


Diagnostic test requirements. | 
Diagnostics must include the feriowing: 
a) Checksum tests for all ROMs and boot blocks. 
b) Video and main memory tests. 3 
c) Basic video circuit tests. 
d) Extensive timer tests. 
e) Basic COPS functional tests, Keyboard and mouse reset test along with 
abasic clock test. . 
f) IWM controller chip tests. 
~ g) RS232 port tests. | 
h) MMU memory and functional tests. 
i) Parity circuit tests. 
j) Hard disk port tests. 


Optional diagnostics available from service mode. 
a) Extensive memory test. 
b) Keyboard test, (only is space permits). 
Cc) Mouse test, (only if space permits). 


Details on diagnost ics will be the ee of a later meeting. 


Extra bug patch spac e » should be designed into the plan for the ROM. 


Manufacturing requirenents. 

The automatic boot special cases must be in the new ROM. These are: 
: a) If there is a test card (wnose I.D. is within a special range) and an 
Applenet card installed, then: the default boot device will be changed to the 
Applenet card. 

ob) If there is a bootable test card (whose I.0. is within a special 

- range), no Applenet card, then the bootable test card will be the default 
boot device 


7 


Must support the crosshatch video pattern for both video modes, also grey 
patterns as must be available. 


CPU board burn-in will be automatically done if the aueetal line provided 
in hardware is set. Additional test requirements are to be provided by 
manufacturing. cas aaa | ; : 


Field Service requirements. 


All requirements are covered in other areas in this document. Additional 
test requirements to be provided by Field Service. 


A Power-Cycling mode must. be provided, details will be provided by Field 
Service and Manufacturing. : 


Error codes will ‘remain the same™ as Lisa 1. 0 for the same failures. 
Additional error codes will be added for new tests and new features. Some error 
codes used inLisai.O are not used inLisai.75._ 


Special debug commands must be available for floppy debugging. 


Office Systems requirenents.. 


The boot process must be very fast and not take much longer than the current 
boot ROM, if possible then be faster than the current process. Tne LISA 1.0 boot 
process, for the boot ROM, takes about 30 seconds. The new boot ROM will be 
targeted for 15 seconds. Additional test requirements to be provided by the 
0.S. group. 


Compatability requirenents. 


Must supply the same interface to expansion cards, so that current 
expansion card ROMs will work without modification. 


al 


Boot ROM Flow 


| Reset exception vector base to point to ROM routines | 


| theckeum test of 911 four ROME 


ww; Wong Flag ROM if possible. 
Fatal Error 
| Memory test of Video memory 
| Pass Fail 
qe __\ Fatal Error - 
| Parity Circuit test of video memory. | ° | 
Pass} Fad | | 
Fatal Error . ; 
Video circuitry test, VTIR. | | Locate a good screen in video © 
[ viseo ctr : a | memory and place message there. 
_ Pass | Fail 
| Display desktop Fatal Error Fatal Error 
: | Read system serial number. and display it 
© Malid Po | . Invalid 
| Display that timer is being tested.. a 
a Fatal Error 
| Timer Chip test, timer #0. 
| ssi SP) \ Fatal Error 
| Timer chip test, timer #1.) 


Pass: Fail 


. ——, Fatal Error 

| Timer Chip test, timer #2.  % 
| * Pass oe 8 | 
Non-Fatal error, set flag of failure. |- 


| Display Clock/Calendar being. tested. 


| COPS, Clock/Calendar test. 
Pass 


| Non-Fatal error, set flag of failure. 


| Display that RS232 being tested. | 


| RS232 Port A test. ng 
Fad \ 

—Passp -Non-Fatal error, set flaq of failure. 

Make this device an illegal boot device. 


RS232 Port B test. 


Pass | 


Non-Fatal error, set flaq of failure. | 
Make this device an illegal boot device. | 


| Size Main Memory, display how much is there. 


If any Main memory is there, | 
then do MMU and memory tests. 


Nenory installed | DG No Memory 
Display that MMU being tested _ | 3 | 
MMU register read/write tests. | 


Fail | Pass : 
Fatal Error REG HET pega . 
MMU register address test. a > 
Fatal Error“ "* labor 


| Display that memory is being tested. | re a2 -_ 
po | Main memory tests. | 7 a Pee 2 
| Non-Fatal Error aa | 


| Re-size memor aoa ee Pass a ae ; 
Parity Circuit test of main memory. } 


Fail / Pass 
Fatal Error | MMU functional test. | 
Fail }Pass * . 
Fatal Error ” te 


_ Map MMU for O.S. startup | 


Olsplay that IWM being tested. 


IWM (Floppy disk) chip diagnostic. 
: _ Fail 


_ Non-Fatal error, set flag of failure. 
[Make this device an illegal boot device. 


| Display that built-in port being tested. 
| Build-in hard disk port diagnostic. 


Pass 


Pass Non-Fatal error, set flag of failure. 
. 2 Make this device an illegal boot device. | 


| Display expansion card as being tested. 
| Expansion Slot card status diagnostics, all 3 slots. - 


‘Pass | Fail 


Non-Fatal error, set flag of failure. | 
Make this device an illegal boot device. | 


Condition hardware | _ 7 ; 
MMUMemoryste hee? . 


_ Pass[ (| Fadl 


Fatal Error 


| Any non-fatal errors? 


No Yes 


" §top to display ‘any non-Fatal errors | 
At this point user can see & use keyboard. 


Continue : Restart 


Get any keyboard activity E | 
Let Caps Lock and any Mouse inputs go past. | 


None | Keys pressed 
Evaluate keys for an alternate boot device. 


| Get boot device from COPS - 
= Other keys Service mode 
| Check to see if boot device is ee. 


Legal; . auisget 


ene. asks for boot device 


Got device Cot turnoff Got service code 


i 
{ 
j 


ox Fails Go to service mode 


Flag failure 
[ Branch to boot code | 


Start boot process | | 


[ Fatal Error 
| Display error | 


‘Allow Retry, Power Off 


Service Node 


“Boot from Profile 


-e me wait Alert 


init sa Port 


= Sania 


“aS File 1.0, code 
Pia 


error 


E Init exception vectors, tad in case. 
~ Go do Boot Go to monitor for 
new boot device 


Floppy disk Boot 


Display Wait alert 


Enable arive 


Error, tineout 


FDIR present? 


a Yes No 
7 -- | Clear interrupts 
Error, timeout. 


Read sector QO, track 0 | 


Timeout OK Other 


.. | Does File 1.0. say bootable? 


No a Yes 


| Read. sector 0, track 1 | 
ye Error OK 
Read sector 0, track 0 


Error OK 


Does File 1.0. say bootable? 


No Yes 


/ 


| Setup exception vector, just in case. 


| ie es 
Send reset signal, keyboard reset 


[Cicer reset 


Clear first byte of keyboard queue 


Lisa 1.75 Boot ROM Layout 


Jump tables. 


Nain entry point. ~° 
Diagnostics. 
Graphics routines. 
Default exception handlers. 
Special hardware handlers. 


Boot process startup code, diagnostics control. 


| Nodularized diagnostic routines. | | 
| Actual boot-up launchers, boot specific devices. | 


| Service mode debug package _| 
Fatal error handler. 


| Hardware setup routines, @.g. MMU. 


| Default exception vector handlers. | 


| Drivers, those Hardware Interface doesnot handle well enough. 
| Specialized Boot ROM graphics. 

| Standard graphics package. | 

| Keyboard 6 Mouse handiers. | ee 


i [ Init some hardware. | 


: | * Diagnostic tests. : 
3 If a port tests out as bad then 
Incr screen counter | make it an illegal boot device. 


, — — Non-fatal | Fatal. 


Get any alternate boot devices from the keyboard. 
None J . | Valid : . Invalid 

Is CPU burn-in bit set? 7 

Yes No 


Get boot device from the COPS 
No Device 


A Device 


Use default of hard disk. 


{Is ita legal port? | 


Yes No 


Try to boot 


Bring in boot block: and check checksum. 


5ad 


——rerck toot code —«=Ct«* GB mesa Sree 


Loop on failure 
or go into TALK 
depending on the 
failure. 


Menu to ask for boot device 


> 


MEMORY 


Parity 
Circuit 


tw |] sam — 
Video Parity Boot 
Memory Circuit ROM 
video Timer | | COPS | is 
Interface Chip a | 
VTIIR | | | 


— Built-in 
Hard 
Disk 


CARD CAGE 


POWER 
SUPPLY 


& 
Mother Board 


MEMORY 


Lacation SCOMENE Function 


$o00000-$oo7FFF =s(«€“‘éOd«é32«64«wU9G ROMO, Boot, ROH 
$020000-$027F FF —-1,33,65,97 RN 1 
$040000-$047FFF 2,34,66, 93 ROM 2 
SB60000-SO67FFE 335679 RON Sia onintinatenthmen 
$000000-$007FFF ——-30,62,94,126 Screen 0, ‘Data 
$008000-SOOF FFF 30, 62,94, 126 _ Screen 1, Data 
000000-S007FFF 31,63,95,127 - Screen 2, Data 
eat SOrErE 31, 63,95, 127 Screen 3, Data 
$002001 12, 44, 76,108 | Iwi, Phase 0 low 
$002003 12,44, 76,108 . IW, Phase 0 high 
$002005 12, 44, 76,108 Ii, Phase 1 low 
$002007 12, 44,76,108 _ IWH, Phase 1 high 
$002009 12,44,76,108 — TWH, Phase 2 low 
$002008 12,44, 76,108 Iwi, Phase 2 high 
$00200D 12,44, 76,108 Twi. Phase 3 low 
$00200F — :12,44,76,108 TWH, Phase 3 high 
$002011 12,44,76,108 IM, L-Hotor-On 
$002015 12,44, 76,108 IW, Drive select 
$002019 12, 44,76,108 IVA. L6. 
$002010 12, 44,76, 108 IW, L7 : 
$003001 12, 44,76,108 Status register 
are 8005008 nd ele 76108 Satu Tegi ster Pee ee 
$003004 12,44,76,108 TWh, Disk Rotor off 
$003005 — —«:12,44,76,108 Tw, Disk ee on | 
$003006 12, 44,76,108 Hard disk interrupt mask, disable 
at 9003007 1244, 76,108 | Hard disk interrupt nask, enable 
$00300C 12,44,76,108 TxD A/LED (enable/OFf) 
ere. $003000 enmnde MM, 76,208 /TxO APLED (Disable/ON) 
$0030CE 12,44, %6, 108 . Hard disk cui nask, : ‘disable 
ae * 900500F concn teed, 76,108 | Hard disk parity ask, efable oe 
$003020 12, 44,76,108 Memory parity enable 
ooo $003030 dee 76,108  Nenory parity disable Eo ee 
$003040 12,44,76, ‘108 TWA Hoad select : Side 0 
ee. $005050 coun tee 44,768,108 | TWH, Head select ~ Side do 
$003060 12,44,76,108 © Hard disk interface ono line low 
“een, 9008070, 12544; 767108 Hard disk interface GHD Line high bere 
$0030c0 12,44,76,108 Disable Vertical Retrace Interrupt 
a ea OREM teh ap octobre he Oe 
$0030AA 12,44,76,108 - : Set screen to 0, read 
$0030AB 12,44,76,108 == Set screen to 1, read 
- $0030BA 12,44,76,108 , Set screen to 2, read ; 
$00308B 12, 44,76,108 Set screen to 3, read 
~ $004001 "12,44,76,108 Read/Load fines Counter 0 
$004003 12, 44, 76,108 Read/Load Tiner Counter 1 
$004005: 12,44,76,108 Read/Load pass Counter 2 
$004007 12,44,76,108 Write to tiner rode register 7 
$006001 12,44,76,108 * $cc, Channel B Control 
$006003 12, 44,76,108 SCC, Channel A Control 
$006005 12,44,76,108 ~ SCC, Channel B Data 
$006007 | «12,44, 76. 10st "Soc, enna A Data . 
$007000 - 12,44, 76, 108 Ss Error address latch’ — 
$007001 — _.. 12,44,76,108, © Audio and Contrast latch | 


